From: Benjamin Gilbert <bgilbert@redhat.com>
Date: Wed, 14 Jul 2021 20:07:16 +0000 (-0400)
Subject: man: improve statoverride description
X-Git-Tag: archive/raspbian/2022.1-3+rpi1~1^2~20^2^2~23^2
X-Git-Url: https://dgit.raspbian.org/%22http://www.example.com/cgi/%22/%22http:/www.example.com/cgi/%22?a=commitdiff_plain;h=5b5d3b12fb3f6ef4875f2fd2b65e99a8b3fdfb91;p=ostree.git

man: improve statoverride description

A statoverride file written in the obvious way will produce incorrect
results for two independent reasons.  Document them.
---

diff --git a/man/ostree-commit.xml b/man/ostree-commit.xml
index 81af7bf2..e1e3a8b9 100644
--- a/man/ostree-commit.xml
+++ b/man/ostree-commit.xml
@@ -232,7 +232,9 @@ Boston, MA 02111-1307, USA.
                 <term><option>--statoverride</option>="PATH"</term>
 
                 <listitem><para>
-                    File containing list of modifications to make permissions (file mode, followed by space, followed by file path).
+                    File containing list of modifications to make permissions (file mode in
+                    decimal, followed by space, followed by file path).  The specified mode
+                    is ORed with the file's original mode unless preceded by "=".
                 </para></listitem>
             </varlistentry>